How to compile MiNT 0.99 PL2 with PureC
---------------------------------------

Julian F. Reschke, 29. Januar 1993
email: julian@math.uni-muenster.de


(1) What you'll need

The original MiNT 0.99 PL2 source distribution (mint99s.zoo). A working 
`patch.ttp'. A command line shell with I/O redirection, like `Mupfel' or 
all these fine Unix shells for MiNT.


(2) What to do

Make a directory and unpack mint99s.zoo in it. Then, make a subdirectory 
called `purec'. Copy all files from *this* archive (mnt99pc.zoo) into this 
subdirectory. Then go back to the MiNT source directory and apply the 
diffs:

	patch < purec\diffs


(3) DEFINEs

You will want to undefine MULTITOS if you're not going to use the 
current beta release of Atari's multitasking AES. And please note that the 
ROM AES doesn't work at all with MiNT's memory protection, so you'll have 
to turn that off when running on an 68030 Atari (see the command line 
switches).



(4) Special files

First of all, you need a special osbind.h. This is because Pure's own 
version differs in some small details from the GCC header files. You 
can't use Pure's tos.h, either, because in its latest versions it already 
defines some of MiNT's data structures. You can either copy osbind.h into 
the MiNT source directory or copy it into your PureC include folder. If 
you are using the MiNT library, all should work fine without this file.

This is all what's needed. You can either use the command line versions 
of PureC, or you can use the PureC shell (copy mintpure.prj to the source 
directory). I am compiling MiNT with GNU make (latest version at 
atari.archive.umich.edu should work fine) and a self-made 'cc' command, 
that I've specially written for the PureC command line versions (see 
makefile.pcc). This tool is still being tested, and I've not yet decided 
how to distribute it. If you are interested, write to me.

If you're going to use the PureC shell, you'll have to 'manually' 
translate the .spp files to the PASM syntax using asmtrans.ttp. The 
syntax is

asmtrans -purec -o outfile.s outfile.spp

genmagic.ttp is needed to create the file magic.i, which in turn is 
included by the .spp files.


(5) Things to do

So far, I've made no attempt to translate asmtrans with PureC. Try it 
yourself (you'll need alloca; might work with the MiNT library version 
for PureC) or compile them with gcc.


(6) Caveats

This is a preliminary 'port'. It seems to work fine on my machine, but 
this guarantees nothing:

There's still a conflict in the way PureC saves registers with what MiNT 
file system drivers or device drivers expect. You will have to use PureC 
1.1 to get the correct behaviour.